nginx 常用命令与基础配置

常用命令

  1. 启动: nginx
  2. 使用指定配置文件启动: nginx -c /path/to/file
  3. 正常停止: nginx -s quit
  4. 快速停止: nginx -s stop
  5. 重新加载配置: nginx -s reload 或 systemctl reload nginx
  6. 重启: systemctl restart nginx
  7. 测试配置文件: nginx -t

基础配置

nginx 的默认配置文件路径为 /etc/nginx/nginx.conf 该文件初始包含了 include /etc/nginx/conf.d/*.conf; 和 include /etc/nginx/sites-enabled/*; 通常将自定义的配置文件写到 /etc/nginx/sites-available/ 目录中，然后软链接到 /etc/nginx/sites-enabled/

示例

基础示例

1server {
2    listen       80;                    # 监听的端口
3    server_name  _;                     # 服务器名（域名或IP地址）下划线表示匹配所有名称
4 
5    location / {
6        root   /var/www/html/;          # 网站根目录
7        index  index.html;              # 默认页面
8    }
9}

代理到 PHP

安装相关的包：apt install php-fpm php php-mysql

1server {
2    listen       80;                                    # 监听的端口
3    server_name  _;                                     # 服务器名（域名或IP地址）下划线表示匹配所有名称
4 
5    location / {
6        root   /var/www/html/;                          # 网站根目录
7        index  index.html index.php;                    # 默认页面
8    }
9
10    location ~ \.php$ {
11        root   /var/www/html/;                          # 网站根目录
12        include snippets/fastcgi-php.conf;
13    
14        # With php-fpm (or other unix sockets):
15        fastcgi_pass unix:/run/php/php8.1-fpm.sock;     # 使用 php-fpm 作为 CGI，版本号根据实际情况配置
16    }
17}

反向代理

绕过 CORS

1server {
2    listen       80;
3    server_name  localhost;
4 
5    location / {
6        proxy_hide_header Access-Control-Allow-Origin;
7        proxy_hide_header Access-Control-Allow-Headers;
8        proxy_hide_header Access-Control-Allow-Methods;
9        add_header Access-Control-Allow-Origin '*' always;
10        add_header Access-Control-Allow-Headers '*' always;
11        add_header Access-Control-Allow-Methods '*' always;
12        proxy_ssl_server_name on;
13        proxy_pass $URL; 
14    }
15}

多个后端

1http {
2    upstream backend {
3        # 定义多个后端服务器
4        server backend1.example.com;  # 第一个后端服务器
5        server backend2.example.com;  # 第二个后端服务器
6        server backend3.example.com;  # 第三个后端服务器
7
8        # 可以添加更多的后端服务器
9    }
10
11    server {
12        listen 80;  # 监听端口
13
14        location / {
15            proxy_pass http://backend;  # 将请求代理到 upstream 定义的后端服务器
16            proxy_set_header Host $host;  # 设置 Host 头
17            proxy_set_header X-Real-IP $remote_addr;  # 设置真实 IP
18            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 设置 X-Forwarded-For 头
19            proxy_set_header X-Forwarded-Proto $scheme;  # 设置协议头
20        }
21
22        # 可选：设置错误页面或超时
23        error_page 502 = @fallback;  # 如果所有后端都不可用，跳转到 fallback
24    }
25
26    location @fallback {
27        # 处理所有后端都不可用的情况
28        return 503 "Service Unavailable";  # 返回 503 状态码
29    }
30}